Product Purchase Trends API: productPurchaseTrends

The Product Purchase Trends API provides historical data on a customer’s purchase trends. It includes information about the number of orders and total order values over specific time periods. This data helps businesses understand customer buying behaviors and trends over time.

API Endpoint and Method

URL Format

Copy 
https://{B2B_API_URL}/api/v1/profile/b2b/productPurchaseTrends

Example URL

Copy 
https://api-dev.algonomy.com/rcdpapi/api/v1/profile/b2b/productPurchaseTrends

HTTP Method

POST

Request Header Parameters

Parameter

 Type Required or Optional

Description
access_token

String

Required

 Specifies the access token obtained from the create access token API.
tenant_hash

String

Required

 Specifies the tenant hash shared with the tenant.
gcrId String Required Specifies the Golden Customer Record ID (GCR ID).
mobile_number String Required

Specifies customer's mobile number.

Example: "1212121212"
email_address String Required

Specifies customer's email address.

Example: "customer@example.com"

customer_code_external

String

Required

Specifies the external customer code.

Example: "123456"
    Notes:

  • You can send all the parameters (gcrId, mobile_number, and email_address) with the request or just one, as at least one parameter is required.

  • These parameters are supported based on the configuration. If your deployment is configured to use them as columns for deduplication, they will be available for use in the API call.

Request Body

None

Response Body

A successful request returns a "200-OK" status code, accompanied by the retrieved data in the response.

Copy 
{
  "status": "OK",
  "message": "",
  "data": {
    "customerId": "1092",
    "currency": "$",
    "title": "Purchase trend (Last 3 months)",
    "dataList": [
      {
        "time": "Jan,22",
        "numberOfOrder": 0,
        "orderValue": 0.0
      },
      {
        "time": "Feb,22",
        "numberOfOrder": 2,
        "orderValue": 1023.0
      },
      {
        "time": "Mar,22",
        "numberOfOrder": 0,
        "orderValue": 0.0
      }
    ]
  }
}